..
  This file was automatically converted from MediaWiki syntax.
  If some markup is wrong, looks weird or doesn't make sense, feel free
  to fix it.

  Please remove this comment once this file was manually checked
  and no "strange ReST" artifacts remain.

.. _enhanced-mouse-navigation:

Enhanced Mouse Navigation
=========================

Enhanced mouse navigation is only available when 'Direct Tools' are enabled.
Information on enabling 'Direct Tools' is available in the :ref:`panda-tools`
section.

Direct Tools gives more functionality to the middle mouse button. First,
clicking the middle mouse button changes the pivot point it uses to rotate
around the environment. The middle mouse button will also move the camera
depending on where the cursor is on the screen.

.. figure:: directtools2.jpg
   :alt: directtools2.jpg

+----------------------------------------+--------------------------------------------------+
| Middle Mouse Click                     | Sets pivot point for rotating around the world   |
+----------------------------------------+--------------------------------------------------+
| Middle Mouse + Middle Region           | Move camera parallel to ground                   |
+----------------------------------------+--------------------------------------------------+
| Shift + Middle Mouse + Middle Region   | Move camera vertically                           |
+----------------------------------------+--------------------------------------------------+
| Middle Mouse + Edge Region             | Rotate camera around pivot point                 |
+----------------------------------------+--------------------------------------------------+
| Middle Mouse + Corner Region           | Roll camera around pivot point                   |
+----------------------------------------+--------------------------------------------------+
| Shift + Middle Mouse + Edge Region     | Changes pitch of the camera                      |
+----------------------------------------+--------------------------------------------------+


The left mouse button is now used to select and manipulate objects in the
environment. Once an object is selected, it may be moved and rotated.

+--------------------------------------+----------------------------------------+
| Left Mouse Click                     | Select an object                       |
+--------------------------------------+----------------------------------------+
| Left Mouse + Middle Region           | Move object vertically                 |
+--------------------------------------+----------------------------------------+
| Shift + Left Mouse + Middle Region   | Move object parallel to ground         |
+--------------------------------------+----------------------------------------+
| Left Mouse + Edge Region             | Rotate object around its pivot point   |
+--------------------------------------+----------------------------------------+
| Left Mouse + Corner Region           | Roll object around its pivot point     |
+--------------------------------------+----------------------------------------+
| Control + Left Mouse                 | Rescale the model                      |
+--------------------------------------+----------------------------------------+


Direct Tools uses a large number of hot keys for camera control, rendering
styles, and object control. The full list is in the table below.

+---------------------+---------------------+---------------------+---------------------+
| **Camera Control**  |                     | **Render Style**    |                     |
+---------------------+---------------------+---------------------+---------------------+
| +                   | Zoom in             | Shift + A           | Show all            |
+---------------------+---------------------+---------------------+---------------------+
| -                   | Zoom out            | Control + F         | Flash selected      |
+---------------------+---------------------+---------------------+---------------------+
| 1                   | Front view          | B                   | Toggle backface     |
|                     | (relative to        |                     |                     |
|                     | render)             |                     |                     |
+---------------------+---------------------+---------------------+---------------------+
| 2                   | Back view (relative | L                   | Toggle lights       |
|                     | to render)          |                     |                     |
+---------------------+---------------------+---------------------+---------------------+
| 3                   | Right view          | T                   | Toggle texture      |
|                     | (relative to        |                     |                     |
|                     | render)             |                     |                     |
+---------------------+---------------------+---------------------+---------------------+
| 4                   | Left view (relative | W                   | Toggle wireframe    |
|                     | to render)          |                     |                     |
+---------------------+---------------------+---------------------+---------------------+
| 5                   | Top view (relative  |                     |                     |
|                     | to render)          |                     |                     |
+---------------------+---------------------+---------------------+---------------------+
| 6                   | Bottom view         | **Direct Controls** |                     |
|                     | (relative to        |                     |                     |
|                     | render)             |                     |                     |
+---------------------+---------------------+---------------------+---------------------+
| 7                   | ¾ view (relative to | Delete              | Delete selected     |
|                     | render)             |                     | object              |
+---------------------+---------------------+---------------------+---------------------+
| 8                   | Roll view about     | Escape              | Delete all          |
|                     | axis relative to    |                     |                     |
|                     | camera’s axis       |                     |                     |
+---------------------+---------------------+---------------------+---------------------+
| 9                   | Rotate around hot   | Page Down           | Move down selected  |
|                     | point               |                     | object’s hierarchy  |
+---------------------+---------------------+---------------------+---------------------+
| 0                   | Rotate around hot   | Page Up             | Move up selected    |
|                     | point               |                     | object’s hierarchy  |
+---------------------+---------------------+---------------------+---------------------+
| C                   | Center on hot point | Tab                 | Toggle widget mode  |
+---------------------+---------------------+---------------------+---------------------+
| F                   | Fit on hot point    | Shift + F           | Grow widget to fit  |
|                     |                     |                     | current window      |
+---------------------+---------------------+---------------------+---------------------+
| H                   | Move to (0,0,0)     | I                   | Plant selected      |
|                     |                     |                     | object at cursor    |
|                     |                     |                     | intersection point  |
+---------------------+---------------------+---------------------+---------------------+
| Shift + L           | Toggle camera pivot | M                   | Move widget in      |
|                     | point lock          |                     | front of camera     |
+---------------------+---------------------+---------------------+---------------------+
| N                   | Select next         | P                   | Set active parent   |
|                     | possible camera COA |                     | to selected object  |
|                     | (along last         |                     |                     |
|                     | intersection ray)   |                     |                     |
+---------------------+---------------------+---------------------+---------------------+
| U                   | Orbit upright       | R                   | WRT reparent        |
|                     | camera about hot    |                     | selected to active  |
|                     | point               |                     | parent              |
+---------------------+---------------------+---------------------+---------------------+
| Shift + U           | Upright camera      | Shift + R           | Reparent selected   |
|                     |                     |                     | to active parent    |
+---------------------+---------------------+---------------------+---------------------+
| \`                  | Kill camera move    | S                   | Reselect last       |
|                     | task                |                     | selected object     |
+---------------------+---------------------+---------------------+---------------------+
|                     |                     | V                   | Toggle widget       |
|                     |                     |                     | visibility          |
+---------------------+---------------------+---------------------+---------------------+
| **Undo/Redo**       |                     | Shift + V           | Toggle COA marker   |
|                     |                     |                     | visibility          |
+---------------------+---------------------+---------------------+---------------------+
| [                   | Undo                | <                   | Shrink widget       |
+---------------------+---------------------+---------------------+---------------------+
| ]                   | Redo                | >                   | Expand widget       |
+---------------------+---------------------+---------------------+---------------------+